home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3c / mq_unlink.z / mq_unlink
Encoding:
Text File  |  1998-10-20  |  3.6 KB  |  67 lines
  1.  
  2.  
  3.  
  4. mmmmqqqq____uuuunnnnlllliiiinnnnkkkk((((3333cccc))))                                                    mmmmqqqq____uuuunnnnlllliiiinnnnkkkk((((3333cccc))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _mmmm_qqqq______uuuu_nnnn_llll_iiii_nnnn_kkkk - remove a message queue
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_mmmm_qqqq_uuuu_eeee_uuuu_eeee_...._hhhh_>>>>
  13.  
  14.      _iiii_nnnn_tttt _mmmm_qqqq______uuuu_nnnn_llll_iiii_nnnn_kkkk _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_m_q__n_a_m_e_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _mmmm_qqqq______uuuu_nnnn_llll_iiii_nnnn_kkkk removes the message queue named by the pathname, _m_q__n_a_m_e.  If
  18.      one or more processes has the message queue opened, the queue will be
  19.      removed after all the processes close the queue. When all the references
  20.      to the queue are gone the space occupied by the queue is released.  After
  21.      a successful call to unlink, the queue, _m_q__n_a_m_e, will not be accessible
  22.      by any process that does not already have access to the queue, by a call
  23.      to _mmmm_qqqq______oooo_pppp_eeee_nnnn(3c).
  24.  
  25.      _mmmm_qqqq______uuuu_nnnn_llll_iiii_nnnn_kkkk will fail if one or more of the following conditions are true:
  26.  
  27.      [EACCES]       Permission to remove the queue is denied.
  28.  
  29.      [EACCES]       A component of path prefix has no search permission or
  30.                     does not exist.
  31.  
  32.      [EINTR]        A signal interrupted the _mmmm_qqqq______uuuu_nnnn_llll_iiii_nnnn_kkkk function call.
  33.  
  34.      [ENOENT]       The named queue does not exist.
  35.  
  36.      [ENAMETOOLONG] The length of the _m_q__n_a_m_e argument exceeds {_PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX}, or
  37.                     the length of a _m_q__n_a_m_e component exceeds {_NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX} while
  38.                     {______PPPP_OOOO_SSSS_IIII_XXXX______NNNN_OOOO______TTTT_RRRR_UUUU_NNNN_CCCC} is in effect.
  39.  
  40. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  41.      _mmmm_qqqq______oooo_pppp_eeee_nnnn(3c), _mmmm_qqqq______cccc_llll_oooo_ssss_eeee(3c), _iiii_nnnn_tttt_rrrr_oooo(3c), _mmmm_qqqq______rrrr_eeee_cccc_eeee_iiii_vvvv_eeee(3c), _mmmm_qqqq______ssss_eeee_nnnn_dddd(3c),
  42.      _mmmm_qqqq______gggg_eeee_tttt_aaaa_tttt_tttt_rrrr(3c), _mmmm_qqqq______ssss_eeee_tttt_aaaa_tttt_tttt_rrrr(3c), _mmmm_qqqq______nnnn_oooo_tttt_iiii_ffff_yyyy(3c)
  43.  
  44. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  45.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  46.      of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.